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1 Overview of Stabs 



Stabs refers to a format for information that describes a program to a debugger. This 
format was apparently invented by Peter Kessler at the University of California at Berkeley, 
for the pdx Pascal debugger; the format has spread widely since then. 

This document is one of the few published sources of documentation on stabs. It is 
believed to be comprehensive for stabs used by C. The lists of symbol descriptors (see Ap- 
pendix B [Symbol Descriptors], page 51) and type descriptors (see Appendix C [Type De- 
scriptors], page 53) are believed to be completely comprehensive. Stabs for COBOL-specific 
features and for variant records (used by Pascal and Modula-2) are poorly documented here. 

Other sources of information on stabs are Dbx and Dbxtool Interfaces, 2nd edition, by 
Sun, i988, and AIX Version 3.2 Files Reference, Fourth Edition, September 1992, "dbx 
Stabstring Grammar" in the a.out section, page 2-31. This document is believed to incor- 
porate the information from those two sources except where it explicitly directs you to them 
for more information. 

1.1 Overview of Debugging Information Flow 

The GNU C compiler compiles C source ina'.c' file into assembly language ina'.s' 
file, which the assembler translates into a ' . o' file, which the linker combines with other 
' . o' files and libraries to produce an executable file. 

With the '-g' option, GCC puts in the '.s' file additional debugging information, which 
is slightly transformed by the assembler and linker, and carried through into the final exe- 
cutable. This debugging information describes features of the source file like line numbers, 
the types and scopes of variables, and function names, parameters, and scopes. 

For some object file formats, the debugging information is encapsulated in assembler 
directives known collectively as .stab (symbol table) directives, which are interspersed with 
the generated code. Stabs are the native format for debugging information in the a.out and 
XCOFF object file formats. The GNU tools can also emit stabs in the COFF and ECOFF 
object file formats. 

The assembler adds the information from stabs to the symbol information it places 
by default in the symbol table and the string table of the '.o' file it is building. The 
linker consolidates the ' . o' files into one executable file, with one symbol table and one 
string table. Debuggers use the symbol and string tables in the executable as a source of 
debugging information about the program. 

1.2 Overview of Stab Format 

There are three overall formats for stab assembler directives, differentiated by the first 
word of the stab. The name of the directive describes which combination of four possible 
data fields follows. It is either .stabs (string), .stabn (number), or .stabd (dot). IBM's 
XCOFF assembler uses .stabx (and some other directives such as .file and .bi) instead 
of .stabs, .stabn or .stabd. 

The overall format of each class of stab is: 



